home *** CD-ROM | disk | FTP | other *** search
/ Aminet 50 / Aminet 50 (2002)(GTI - Schatztruhe)[!][Aug 2002].iso / Aminet / disk / misc / diskimage.readme < prev    next >
Text File  |  2002-05-19  |  9KB  |  195 lines
  1. Short:    Mount any disk image file as a DOS device
  2. Author:   tboeckel@uni-paderborn.de (Thore Boeckelmann)
  3. Uploader: tboeckel@uni-paderborn.de (Thore Boeckelmann)
  4. Type:     disk/misc
  5. Replaces: DiskImage.lha
  6.  
  7. TITLE
  8.   DiskImage
  9.  
  10.  
  11. VERSION
  12.   37.4
  13.  
  14.  
  15. AUTHOR
  16.   Thore Böckelmann <tboeckel@uni-paderborn.de>
  17.  
  18.  
  19. REQUIREMENTS
  20.   Any Amiga® (compatible) computer with at least OS2.04 and 68020+ cpu.
  21.  
  22.  
  23. DESCRIPTION
  24.   A long time ago I found a device called "fmsdisk.device" on Aminet. It allowed
  25.   you to mount a file on your harddisk as a regular floppy disk. You could then
  26.   use this new drive exactly like DF0:. Unforturnately FMS often crashed on my
  27.   machine upon mounting the image, and, even worse, FMS didn't allow you to swap
  28.   these virtual floppies, nor did it support compressed images. Especially
  29.   compressed images are very popular since the Amiga emulator UAE existed. The
  30.   only way to swap a disk with FMS was to prepare another disk image and
  31.   transfer it to FMS with tools like TransADF or similar. From my point of view
  32.   that is neither very convenient, nor very intuitive.
  33.  
  34.   DiskImage goes a slightly different way. Instead of mounting a static file you
  35.   just mount the drive, eg. DI0:, and then you "insert" the disk image of your
  36.   desire with a special tool. This image can be ejected at any time and replaced
  37.   by another image in a way that is completely transparent to AmigaOS. DiskImage
  38.   supports nearly all trackdisk commands and disk change interrupts. And even
  39.   more important: it supports gzip compressed disk images via Achim Stegemann's
  40.   free zlib.library. Additionally you are not limited to images from floppy
  41.   disks, but you can use image files from any device you can imagine. It is even
  42.   possible to dump your whole harddisk to a file and then mount this file as a
  43.   mirror of your harddisk. The only limitation is AmigaDOS's limit on the size
  44.   of a file, which is 2GB minus 2 bytes (= 2,147,483,646 bytes).
  45.   On big advantage is the ability to mount CD-ROM ISO image files. That means if
  46.   your CD writer is not able to write to CD-RW disks (ok, all recent writers are
  47.   able to do that) or you don't have a CD-RW disk at hand, then you simply
  48.   create an ISO image with MakeCD and mount this image via diskimage.device.
  49.  
  50.  
  51. USAGE
  52.   diskimage.device supports up to 10 different units each of which can have its
  53.   own device layout, that is FileSystem, number of cylinders, etc. All this is
  54.   determined by standard Amiga mount files.
  55.  
  56.   You must use DiskImageCtrl to swap the images in the different unit. Its shell
  57.   template is:
  58.  
  59.   DRIVE=DEVICE/K,UNIT/K/N,EJECT/S,READONLY=RO/S,GUI/S,IMAGE=INSERT,CX_POPUP/K
  60.  
  61.   DRIVE=DEVICE/K: either "diskimage.device" or a DOS device like "DI0:" to
  62.                   obtain the unit number from
  63.   UNIT/K/N: unit of diskimage.device you want to be affected. If no unit number
  64.             is given then unit 0 is assumed.
  65.   EJECT/S: this switch will eject the inserted disk image 
  66.   READONLY/S: mount the image in read-only mode, every write attempt will be
  67.               rejected with a "write protected" error
  68.   GUI/S: use the MUI interface instead of the shell interface
  69.   IMAGE=INSERT: name of a new disk image file that you wish to insert. This can
  70.                 either be a normal uncompressed file or a file compressed with
  71.                 the GNU gzip command
  72.   CX_POPUP/K: open the MUI interface (YES, TRUE, 1), or simply install as a
  73.               commodity (NO, FALSE, 0)
  74.  
  75.  
  76.   Without any arguments DiskImageCtrl will show a list of which image file is
  77.   inserted in which unit of diskimage.device.
  78.  
  79.   After insertion you can use the mounted image like any other drive in your
  80.   system. You can read, write, create and delete files, copy the whole disk via
  81.   DiskCopy, repair the disk with Dave Haynie's DiskSalv, start programs, format
  82.   the disk. To make it short: you can do anything with the image that you can
  83.   imagine for any other device.
  84.  
  85.   For gzip compressed images there is one thing to mention:
  86.  
  87.   gzip compressed images are decompressed on-the-fly when you insert the image
  88.   file and any access will take place on the decompressed image, not on the
  89.   compressed image itself. But that means, that any change done to the disk will
  90.   be dead and gone as soon as you eject the image from diskimage.device. The
  91.   disk will be in the same state upon reinsertion as it was the first time when
  92.   you inserted it. That means you can change anything on the image, but all
  93.   these changes are non-permanent!! If you wish them to be permanent, then you
  94.   have to decompress the image by hand (via gunzip <file>.gz) and then insert
  95.   the decompressed image. On the other hand you can modify anything on such an
  96.   image without any loss of data, because the original compressed image is not
  97.   touched in any way!
  98.  
  99.   Due to the size of uncompressed images compared to compressed ones there is a
  100.   way to tell diskimage.device where to store the temporary images. The default
  101.   is "T:". To override this path you will have to set the environment variable
  102.   "DiskImageTempPath" via the setenv command. This path will be used furtheron
  103.   for temporary disk images. Make sure that you have enough space left on the
  104.   device that path belongs to!!
  105.  
  106.  
  107.   Usage examples:
  108.  
  109.   To insert the disk image "simpleimage.adf" into unit 0 of diskimage.device:
  110.  
  111.     DiskImageCtrl unit 0 insert work:images/simpleimage.adf
  112.  
  113.  
  114.   To insert the gzip compressed disk image "cooldemo.adz" into drive DI2:, which
  115.   has been mounted on diskimage.device unit 2. The file will be uncompressed
  116.   on-the-fly the the path given by the environment variable "DiskImageTempPath":
  117.  
  118.     DiskImageCtrl drive di2: insert work:images/cooldemo.adz
  119.  
  120.  
  121.   To eject an inserted image from unit 3:
  122.  
  123.     DiskImageCtrl unit 3 eject
  124.  
  125.  
  126. INSTALLATION
  127.   Copy diskimage.device to DEVS: and DiskImageCtrl to any place you want to. C:
  128.   would be a very good place. The mount files belong to SYS:Storage/DOSDrivers,
  129.   to be mounted on demand. If you wish to mount a certain drive on every boot,
  130.   then move these files to DEVS:DOSDrivers.
  131.  
  132.  
  133. KNOWN BUGS
  134.   - none known yet
  135.  
  136.  
  137. HISTORY
  138.   37.1 (13.3.2002):
  139.     - inital Aminet release
  140.  
  141.   37.2 (4.4.2002):
  142.     - DiskImageCtrl now has an MUI interface for easy control over all units,
  143.       which works as a commodity. Hence the new place for DiskImageCtrl should
  144.       be the SYS:WBStartup drawer
  145.     - I forgot to include the zlib.library in the initial release
  146.  
  147.   37.3 (16.4.2002):
  148.     - DiskImageCtrl didn't enable the eject button after a successful insertion
  149.       of an image. Thanks to Pixel Art <pixelart@wanadoo.fr> for that hint.
  150.     - images can now be set read-only or read-write on the fly
  151.  
  152.   37.4 (14.5.2002):
  153.     - DiskImageCtrl now uses a pattern when opening the file requester to avoid
  154.       selection of non-image files. The pattern is "#?.(adf|adz|gz|iso)", which
  155.       makes only standard image files visible.
  156.     - this release contains gzip'ed empty image files of several very common
  157.       disk formats:
  158.         + 880K FFS-Intl (std. Amiga DD)
  159.         + 1760K FFS-Intl (std. Amiga HD)
  160.         + 720K FAT (std. MS-DOS DD)
  161.         + 1440K FAT (std. MS-DOS HD)
  162.       Thus you can easily create new images on the fly. Due to the fact that it
  163.       is an empty disk the gzip'ed images have a really very small size (2K to
  164.       15K).
  165.       Remember that any modification to an on-the-fly-gunzip'ed image is lost as
  166.       soon as you eject the image!! So either make a copy of it first, or gunzip
  167.       the provided empty image before you insert it to make your modifications
  168.       permanent.
  169.     - DiskImageCtrl saved complete garbage when changing the temporary image
  170.       path. Thanks to Boris Ivic <borisivic@ptt.yu>.
  171.     - empty path handling was completely broken when DiskImageCtrl was running
  172.       in GUI mode
  173.     - inserting images via Shell now updates the GUI, if running, thus the GUI
  174.       always shows consistent data.
  175.     - diskimage.device now prefers xadmaster.library over zlib.library for
  176.       compressed disk images. This allow a huge bunch of new (maybe more
  177.       efficient) compression methods, as long as you have a suitable xad client
  178.       for decompression.
  179.     - Sorry, but no tool to create empty image files yet. I have been too lazy.
  180.       Maybe in the next release...
  181.  
  182.  
  183. COPYRIGHT AND DISCLAIMER
  184.   DiskImage is copyrighted 2001,2002 by Thore Böckelmann.
  185.   All rights reserved. This program is freeware, so no financial donations  
  186.   required. Redistribution allowed if the package is left unchanged. The author
  187.   is not responsible for any damage caused by the use or misuse of this
  188.   documentation and/or the program(s) it describes.
  189.  
  190.   DiskImageCtrl uses the SmartReadArgs package by Thomas Aglassinger and the
  191.   zlib.library and XAD decompression system by Achim Stegemann.
  192.  
  193.  
  194. SEE ALSO
  195.